home *** CD-ROM | disk | FTP | other *** search
/ Workbench Design / WB Collection.iso / workbench werkzeuge / workbench erweiterungen / darksound / darksound.eng.guide (.txt) < prev    next >
Amigaguide Document  |  1996-04-07  |  10KB  |  214 lines
  1. @DATABASE "DarkSound"
  2. @NODE "MAIN" "MAIN"
  3. @TOC "MAIN"
  4. *****************************************
  5. *        `DarkSound'  V 2.1        *
  6. *       An OriginalWare release by      *
  7. *    Troglobyte/Darkness 
  8.  1994    *
  9. *****************************************
  10. Contents
  11. ========
  12. @{"1. Introduction" LINK "1"}
  13. @{"2. Instructions" LINK "2"}
  14. @{"3. ToolTypes" LINK "3"}
  15. @{"4. Errors and solutions" LINK "4"}
  16. @{"5. History" LINK "5"}
  17. @{"6. What is OriginalWare?" LINK "6"}
  18. @{"7. Thanks" LINK "7"}
  19. @{"8. Credits" LINK "8"}
  20. @ENDNODE
  21. @NODE "1" "Introduction"
  22. @TOC "MAIN"
  23. 1. Introduction
  24. ===============
  25. Are  you  tired  of  hearing the same sound alert each time the Amiga warns
  26. DarkSound  is the answer to your prayers!  It will randomly choose a sample
  27. each time you boot your machine.Now, your errors won't sound the same.#8>)
  28. DarkSound  will  play  a  random  Start sample anytime you load it and will
  29. select another random Alert sample to be used as the system sound Alert.
  30. DarkSound  is  very  easy  to  install,  and  once installed you can't live
  31. without  it,  and  with  the  correct sample you can always surprise others
  32. Amiga and PC users, you even can surprise yourself.
  33. @ENDNODE
  34. @NODE "2" "Instructions"
  35. @TOC "MAIN"
  36. 2. Instructions
  37. ===============
  38. To  install  DarkSound just drag his icon to the `DH0:WBStartup' drawer, or
  39. copy  the  `DarkSound'  and `DarkSound.info' to you `SYS:WBStartup' drawer.
  40. Then  configure  the ToolTypes of the icon (for more info look at Section 3
  41. of this instructions:  3.  ToolTypes)
  42. DarkSound  (optionally)  will play another sample each time you run it; and
  43. as DarkSound must be installed in your `WBStartup' drawer, this sample will
  44. play  anytime  you init your WorkBench, you can use this sample to warn you
  45. that your Workbench finished loading and your Amiga is ready to be enjoyed.
  46. After  this DarkSound will select another random Alert sample to be used as
  47. the  system sound Alert and then will exit.  Both samples are selected from
  48. different sound lists that you must define in the DarkSound icon ToolTypes.
  49. I  recommend  to  use  longer sounds as Start samples and shorter sounds as
  50. Alert samples, but you can use whatever you want.
  51. The  sound  samples  provided  are  only  for  test, use your own favourite
  52. sounds.
  53. You  can use the `DH0:Prefs/Sound' preferences editor, to select the volume
  54. of  the  samples  and  if  you want a screen flash together with the System
  55. Alert sample.
  56. When  DarkSound  is  executed  it  change  your  sound  prefs  and exit, so
  57. DarkSound don't waste nothing of your precious CPU time and memory.
  58. DarkSound  only edit your RAM:  configuration (RAM:ENV/Sys/Sound.Prefs), so
  59. DarkSound never WRITE nothing to your Hard Disk.
  60. All this is more simple than it sounds #8>) so just check it.
  61. @ENDNODE
  62. @NODE "3" "ToolTypes"
  63. @TOC "MAIN"
  64. 3. ToolTypes
  65. ============
  66. Now you can/must configure DarkSound with the icon ToolTypes.
  67. To  edit configuration, click once the DarkSound icon and press right mouse
  68. button  to  select  in the Workbench menu `Icons' the `Information' option,
  69. you  can  select it pressing at the same time the right `Amiga' key and the
  70. `I' key.Then a window will appear to easily write your own configuration.
  71. There are 2 ToolTypes to select the Start sample :
  72.  ToolType 1 : Start_Name=dh0:Sounds/Sample00.Iff
  73. With  this  you  select  the  path and name of the Start sample you want to
  74. play.   Remember  that  all the samples must have the same name, and a `00'
  75. string anywhere in the name of the sample, but the Sample00 isn't used.
  76.  Examples :
  77. dh1:Sounds/Sound00    - OK
  78. SYS:Sample.00.IFF    - OK
  79. DH0:Sound13        - Bad : the number must be 00 (Sound00, OK)
  80. dh1:Sound000        - Bad : the number must be 2 digit only (Sound00)
  81.  ToolType 2 : Start_Number=03
  82. This  is  the number of samples.  If the number is `00' the Start Sample is
  83.  Example :
  84. With this ToolTypes,
  85.  START_NAME  =dh0:Sounds/Sample00.Iff
  86.  START_NUMBER=03
  87. you must have the samples :
  88.  dh0:Sounds/Sample01.Iff
  89.  dh0:Sounds/Sample02.Iff
  90.  dh0:Sounds/Sample03.Iff
  91. There  are  other  2  ToolTypes  to  select  the  System Alert sample, this
  92. ToolTypes  are  used  like  the  previous 2 ToolTypes, you can use the same
  93. samples or other samples.
  94.  ToolType 3 : Alert_Name  =dh0:Sounds/Alert00.Iff
  95.  ToolType 4 : Alert_Number=07
  96. The other ToolTypes are standard Workbench ToolTypes, and usually you don't
  97. need to change them; if you don't know what they do, don't touch them.
  98.  ToolType 5 : StartPriority=0
  99. This  ToolType  is  used  to  select  in which order WBStartup programs are
  100. loaded, if you use the Start sample I recomend to load DarkSound the last.
  101.  ToolType 6 : DoNotWait
  102. This ToolType tell the system Do Not Wait to this program to finish, so the
  103. system continue loading other programs while executing DarkSound.
  104. @ENDNODE
  105. @NODE "4" "Errors and solutions"
  106. @TOC "MAIN"
  107. 4. Errors and solutions
  108. =======================
  109. If `DarkSound' found any error will open a window with the problem, it will
  110. help you to check out and correct your problems. 
  111. WorkBench 2.1 or later required by DarkSound to work (if you have KickStart
  112. 1.x consider DarkSound another good reason to upgrade your Amiga).
  113. DarkSound  must  be copied in the `SYS:WbStartup' drawer, you must copy the
  114. program  `DarkSound'  and the icon `DarkSound.info' with this names, if you
  115. rename this files, the program won't work.
  116. The  file  `RAM:ENV/Sys/Sound.Prefs' is required, if you don't have it, use
  117. the `SYS:Prefs/Sound' program to create it and select your preferences.
  118. Remember  that  your old `sound.prefs' sample selections are overwritten by
  119. DarkSound  in  RAM:   but  are  still  in your hard disk, so if one day you
  120. decide   to  stop  using  DarkSound,  your  original  preferences  will  be
  121. automatically used again.
  122. If you get the system error `Sound.Prefs is a BAD Prefs File', then one
  123. of your sounds isn't a standard IFF sample, check them with a sound program.
  124. There can be only 100 samples, but this must not be a problem (I think).
  125. If you have any other problem or doubt, contact me (address is at the end)
  126. @ENDNODE
  127. @NODE "5" "History"
  128. @TOC "MAIN"
  129. 5. History
  130. ==========
  131. Version 1.1 ( 8-Apr-94) :
  132.   - First released version.
  133. Version 1.2 (20-May-94) :
  134.  - Play the LAST sound in the list when run it to alert you that your
  135.    WorkBench is loaded, (you can use a long sample like `Commodore is
  136.    dead but your Amiga is still the best computer  and is ready to be
  137.    used' and use smaller samples as alerts) and choose another sample
  138.    randomly for the WB Sound Alert.
  139.  - Improved Docs.
  140.  - MagicWB Icon added.
  141.  - More Samples included (but not good enough yet). 
  142. Version 1.3 (20-Sep-94) :
  143.  - If you use it from CLI will display errors.
  144.  - Code optimized for future versions.
  145.  - FIDO address added :-)
  146. Version 2.0 (10-Nov-94) :
  147.  - Major update.
  148.  - Different sound lists for Start and Alert samples.
  149.  - Added ToolTypes for configuration.
  150.  - Docs in AmigaGuide format.
  151.  - Spanish docs added.
  152. Version 2.1 (25-Nov-94) :
  153.  - Open a window with the errors found.
  154. @ENDNODE
  155. @NODE "6" "OriginalWare"
  156. @TOC "MAIN"
  157. 6. What is OriginalWare ?
  158. =========================
  159. This  utility  is OriginalWare.That means if you like this program you must
  160. buy  an  original  Amiga program or game or send the money to the author of
  161. any ShareWare program or game you are using often.
  162. There  are  lots  of  great Amiga software like `DiskMaster', `Hired Guns',
  163. `Syndicate',   `Goal',  `Vital  Light',  `Pinball  Fantasies',  `Stardust',
  164. `Elfmania' and a lot more that you won't never regret to spend your money.
  165. If  you do this you support the Amiga, and if you support AMIGA you support
  166. OriginalWare  is  a  new  concept  (I  think  so) conceived by me; for more
  167. information or suggestions about OriginalWare, contact me, please.
  168. Support OriginalWare software and you will get more and better software.
  169. DarkSound could be included in any PD compilation, except some samples that
  170. could have different copyrights.
  171. Fred Fish and Aminet collections are specifically allowed to use it.
  172.  To Magazines :
  173. You can give away this utility on your coverdisk, but please send me a copy
  174. of the magazine.
  175. @ENDNODE
  176. @NODE "7" "Thanks"
  177. @TOC "MAIN"
  178. 7. Thanks to:
  179. =============
  180. Amiga Vice for the idea and the 
  181. eta testing.
  182. Hipnooxis for ALL the help and show me to use and respect the Amiga O.S.
  183. Binary for the help with the first docs and much more things.
  184. Knackosoft/TRSI for being my best `invisible' friend.
  185. Alberto Sanchez and David Santamaria for some help in this project.
  186. Everybody responsible of the nice samples.
  187. To the new owner of the Amiga... whoever it will be.
  188. To all the Amiga users worldwide for their trust in the Amiga.
  189. To you for read this and for use DarkSound (because you use it...or not?)
  190. To the Amiga...
  191. @ENDNODE
  192. @NODE "8" "Credits"
  193. @TOC "MAIN"
  194. 8. Credits
  195. ==========
  196. Code by Troglobyte/Darkness with some help by Hipnooxis/Darkness.
  197. Idea by Amiga Vice/Darkness.
  198. The authors of the samples provided.
  199. Send  us  JOB  offers,  BUGS,  comments,  improvements, ideas, suggestions,
  200. disks,  mags,  advices,  complains,  nice  PD  stuff  (like Demos, Games or
  201. Utilities),  and your favourite IFF Sounds samples to include in future and
  202. better versions of this utility :
  203.             M. Martin Vivaldi
  204.              Av. America 60
  205.               Madrid 28028
  206.                  SPAIN
  207. Or NetMail me at :
  208.  Internet : bitabit@servicom.es        (Faster and safer)
  209.  FidoNet  : 2:341/28.55        Manuel Martin
  210.  AmigaNet : 39:192/2.55        Manuel Martin
  211. Coders, musicians and graphicians are available for COMPUTER or CONSOLES
  212. quality works at the above address.
  213. @ENDNODE
  214.